Storing captured data in multiple files7

SGSetOutputNextOutput

The SGSetOutputNextOutput function allows you to specify the order in which sequence grabber outputs should be used.



 
pascal ComponentResult SGSetOutputNextOutput(SeqGrabComponent s, SGOutput sgOut, 

                     SGOutput nextOut)

s: Specifies a component instance identifying your connection to the sequence grabber component. You obtain this value from the Component Manager's OpenComponent function.
sgOut: Specifies the current output to use. When a new output is created, its nextOut is set to nil .
nextOut: Specifies the next output to be used. To specify that this is the last output, set this value to nil .

DISCUSSION

This routine should not be called while recording.

RESULT CODES

To be provided

SGGetOutputNextOutput

The SGGetOutputNextOutput function returns the next sequence grabber output for the specified output.



 
pascal ComponentResult SGGetOutputNextOutput(SeqGrabComponent s, SGOutput sgOut, 

                     SGOutput *nextOut)

s: Specifies a component instance identifying your connection to the sequence grabber component. You obtain this value from the Component Manager's OpenComponent function.
sgOut: Specifies the current sequence grabber output.
nextOut: Contains a pointer to the next output to be used. If there is no next output, this value is nil .

RESULT CODES

To be provided

SGSetOutputMaximumOffset

SGSetOutputMaximumOffset specifies the maximum offset for data written to the specified sequence grabber output.



 
pascal ComponentResult SGSetOutputMaximumOffset(SeqGrabComponent s, SGOutput sgOut, 

                     const wide *maxOffset)

s: Specifies a component instance identifying your connection to the sequence grabber component. You obtain this value from the Component Manager's OpenComponent function.
sgOut: Specifies the current sequence grabber output.
maxOffset: Contains a pointer to the value of the maximum offset for data written to this output.

DISCUSSION

If an attempt is made to write data beyond the maximum offset, sequence grabber switches to the next output specified by SGSetOutputNextOutput . If no more outputs are available, an end-of-file error is returned and recording ends.

RESULT CODES

To be provided

SGGetOutputMaximumOffset

SGGetOutputMaximumOffset returns the maximum offset for data written to the specified sequence grabber output.



 
pascal ComponentResult SGGetOutputMaximumOffset(SeqGrabComponent s, SGOutput sgOut, 

                     wide *maxOffset)

s: Specifies a component instance identifying your connection to the sequence grabber component. You obtain this value from the Component Manager's OpenComponent function.
sgOut: Specifies the current sequence grabber output.
maxOffset: Contains a pointer to the value of the maximum offset for data written to this output.

DISCUSSION

The value of SGGetOutputMaximumOffset is initialized to (2^32 - 1) on systems with a 32-bit file system, and (2^64-1) on systems with a 64-bit file system.

RESULT CODES

To be provided

SGGetOutputDataReference

SGGetOutputDataReference returns information about the data reference associated with the specified sequence grabber output.



 
pascal ComponentResult SGGetOutputDataReference(SeqGrabComponent s, SGOutput sgOut, 

                     Handle *dataRef, OSType *dataRefType)

s: Specifies a component instance identifying your connection to the sequence grabber component. You obtain this value from the Component Manager's OpenComponent function.
sgOut: Specifies the current sequence grabber output.
dataRef: A pointer to the handle in which the data reference is returned. If you do not need the data reference, set this parameter to NIL .
dataRefType: A pointer to an OSType value in which the type of the data reference is returned. If you do not need this information, set this parameter to NIL .

DISCUSSION

The caller is responsible for disposing of the returned handle.

RESULT CODES

To be provided